home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / language / ana_m2_1.arc / RELEASE.DOC < prev    next >
Text File  |  1989-01-09  |  14KB  |  267 lines
  1.           RELEASE NOTES FOR M2/68 VERSION 1.0
  2.           
  3.           INTRODUCTION:
  4.           
  5.           The ana-systems Modula-2 Development System consists of the 
  6.           M2/68 Compiler, Linker, libraries, and Development Shell.  
  7.           The libraries and the Shell were written in Modula-2 and 
  8.           compiled with the ana-systems M2/68 Compiler.
  9.           
  10.           PACKING LIST:
  11.           
  12.           You should find the following files in your package:
  13.           
  14.               ana_m2_1.arc:
  15.                     m2sh.prg       Development Shell
  16.                     m2sh.rsc       English resource file for Shell
  17.                     m2sh_g.rsc     German resource file
  18.                     m2sh.cfg       configuration file for Shell
  19.                     utility.prg    disk utilities program
  20.                     utility.rsc    English resource file for utility.prg
  21.                     util_g.rsc     German resource file
  22.                     readme         read this first
  23.                     release.doc    this document
  24.                     info.doc       product registration form
  25.                     version.doc    the current version
  26.                     copyrigh.doc   copyright message
  27.                     license.doc    your SHAREWARE license
  28.                     ana_prof.doc   profile of ana-systems
  29.                     m2_desc.doc    general description of the M2/68 product
  30.                     sample.ord     product ordering samples
  31.               ana_m2_2.arc:
  32.                     m2.tos         M2/68 Compiler
  33.               ana_m2_3.arc:
  34.                     m2.lnk         M2/68 Linker
  35.               ana_m2_4.arc:
  36.                     def.arc        library Definition files
  37.                     sym.arc        library .SYM files
  38.                     obj.arc        library .OBJ files
  39.               ana_m2_5.arc:
  40.                     emacs.tos      public domain editor
  41.                     emacs.rc       emacs key binding resource
  42.                     emacs.hlp      command list
  43.                     emacs.key      default key binding
  44.                     
  45.           All archives also contain Copyright, License, and Version
  46.           documents.
  47.  
  48.           SYSTEM REQUIREMENTS AND RESTRICTIONS:
  49.           
  50.           The minimum hardware requirements to use the M2/68 system are 
  51.           a 520ST with 2 disk drives (single or double sided) or a 
  52.           1040ST with 1 double sided drive.  What this boils down to is 
  53.           minimum 1 meg and a double sided drive, or 1/2 meg and 2 
  54.           drives.  (See 'Configurations' below for recommended setups.)
  55.           
  56.           The M2/68 Compiler needs about 300K of RAM to compile a small 
  57.           to medium sized program.  If you are using a 512K machine,
  58.           this means you can run the Compiler from the Development 
  59.           Shell but you probably can't use many desk accessories and 
  60.           you  definitely can't use a RAM disk to speed things up.  If 
  61.           you are in this category and the Compiler issues an 'out of 
  62.           memory' message, you must reduce your memory consumption.  You
  63.           can do this by either removing desk accessories (including the 
  64.           control panel) and/or reducing the size of the module you are 
  65.           compiling.  If you have a megabyte of memory you can create a 
  66.           RAM disk and load the libraries into it to speed up 
  67.           compilation and linking.
  68.           
  69.           CONFIGURATIONS:
  70.           
  71.           The following files must always be in the same directory:
  72.                M2SH.PRG       UTILITY.PRG
  73.                M2SH.RSC       UTILITY.RSC
  74.                M2SH.CFG
  75.                
  76.           UTILITY.PRG provides a number of disk utilities which are
  77.           accessible from within M2SH.PRG.  It does not, however, need
  78.           to be present.  When it is missing, the menu selections in
  79.           M2SH.PRG which represent the utility routines are simply
  80.           disabled.
  81.           
  82.           If you have a favorite editor you should use that instead of 
  83.           microEmacs.  We recommend TEMPUS by Creative Computer Design; 
  84.           it is an excellent GEM editor which interfaces closely with 
  85.           the Development Shell (see 'Editor Interface' below).
  86.           
  87.           Setup for 520ST (1/2 meg) with 2 single sided drives:
  88.           
  89.           The disk you will leave in drive A should contain the M2SH 
  90.           and UTILITY files along with your editor and source file.  
  91.           You should prepare Compiler and Linker disks for use in your
  92.           second drive.  The Compiler disk should hold M2.TOS, and a
  93.           subdirectory called something like M2LIB containing all the 
  94.           .SYM files.  The Linker disk should hold M2LNK.TOS, and a
  95.           subdirectory called something like M2LIB containing all the 
  96.           .OBJ files.  With this setup, just before you call the Compiler 
  97.           you must insert the Compiler disk and just before you call the 
  98.           Linker you must insert the Linker disk (into drive B).  If you 
  99.           are using this setup you can use the M2SH.CFG configuration file 
  100.           as supplied with the possible exception of changing the editor
  101.           name (see 'M2SH.CFG' below).
  102.           
  103.           Setup for 1040St (1 meg) with 1 double sided drive:
  104.           
  105.           You should prepare a double sided disk like the one for drive 
  106.           A in the 520ST setup and add to it M2.TOS and M2LNK.TOS.
  107.           You should also prepare a disk with the complete M2LIB
  108.           subdirectory (all .SYM and .OBJ files).  Then, upon bootup 
  109.           you should create a 200-300k RAM disk and load these two 
  110.           subdirectories onto it.  If you are using this set up you 
  111.           will need to adjust some of your M2SH.CFG configuration 
  112.           parameters (see 'M2SH.CFG' below).
  113.           
  114.           Setup for 1040St (1 meg) with 2 drives:
  115.           
  116.           If this is your hardware configuration you have, essentially, 
  117.           your choice of the two configurations given above.  If you 
  118.           want to run the Compiler and Linker from drive B, and if that 
  119.           drive is double sided, you should include on it M2.TOS and
  120.           M2LNK.TOS, along with the full M2LIB subdirectory.  Note
  121.           however that using a RAM disk will improve development speed.
  122.           
  123.           Setup for a system with a hard disk:
  124.           
  125.           You should create a MODULA_2 subdirectory and load the 
  126.           executables and library subdirectory into it.  You may then 
  127.           use the Shell locate facilities to install the various system 
  128.           programs (see 'M2SH.CFG' below).  This is of course the
  129.           recommended set both in terms of speed and convenience.
  130.           
  131.           NOTE: As stated, it is possible to run the whole system from
  132.           one double sided disk on 1/2 meg or more.  You must be careful, 
  133.           however, to leave room for the Compiler and Linker temporary 
  134.           files on the disk.  The amount of room needed depends on the size 
  135.           of the program you are building, and only experimentation will 
  136.           determine the limits.  (If you are sure you won't need any of the
  137.           disk utilities you might leave the UTILITY files off the disk).
  138.           Also, if you have a 1 meg (or greater) machine, you might ex-
  139.           periment more with ram disks to find the fastest and most
  140.           convenient setup.
  141.           
  142.           M2SH.CFG:
  143.           
  144.           The M2SH.CFG file contains a number of parameters which you 
  145.           may set from within the Shell.  Choosing 'Save Config' while 
  146.           in the Shell will alter M2SH.CFG to conform to the current 
  147.           settings.  Each time the Shell is run it looks for this file.  
  148.           If it is found, the Shell sets its parameters according to 
  149.           the file.  The parameters include location of the Editor, 
  150.           Compiler, and Linker among other things.  Most of the 
  151.           parameters are explained in the Shell help screens (press 
  152.           HE